Button.onKeyDown

Доступность

Flash Player 6.

Синтаксис

my_btn.onKeyDown = function() : Void {
  // your statements here
}

Параметры

Нет.

Возвращает

Ничего.

Описание

Обработчик события (Event handler), вызывается, когда кнопка имеет фокус ввода и пользователь нажал клавишу на клавиатуре. Событие onKeyDown не принимает параметров. Вы можете использовать методы Key.getAscii() и Key.getCode() для того, чтобы определить, какая клавиша была нажата.

Вы должны определить функцию, которая выполнится по наступлению этого события.

Пример

В следующем примере для события onKeyDown определяется функция, которая выведет сообщение в окно вывода (Output panel). Создайте в сцене кнопку с именем my_btn и скопируйте следующий код в первый кадр таймлайна:

my_btn.onKeyDown = function() {
  trace("onKeyDown: "+this._name+" (Key: "+getKeyPressed()+")");
};
function getKeyPressed():String {
  var theKey:String;
  switch (Key.getAscii()) {
  case Key.BACKSPACE :
    theKey = "<BACKSPACE>";
    break;
  case Key.SPACE :
    theKey = "<SPACE>";
    break;
  default :
    theKey = chr(Key.getAscii());
  }
  return theKey;
}

Запустите SWF файл (Control > Test Movie). Убедитесь, что горячие клавиши отключены (Control > Disable Keyboard Shortcuts). Затем нажимайте клавишу Tab, пока ваша кнопка my_btn не окажется в фокусе (вокруг кнопки появится желтый прямоугольник). После этого нажимайте клавиши на клавиатуре и сообщения о нажатых клавишах будут появляться в окне вывода (Output panel).

См. также

Button.onKeyUp